Silk Mobile

Table of Contents (Homepage)

Manually Instrumenting iOS Applications

(Optional)

Note: U se this process only if you can't use the iOS Application Instrumentation because you don't have an iOS certificate or provisioning profile.

We provide three instrumented iOS demo applications (the links, below, can be opened only from iOS devices):

  • EriBank can also be found under installation folder: <install dir>\bin\ipas (activity name: com.experitest.ExperiBank)

  • QuickContactsTest (activity name: com.experitest.QuickContacts)

  • UICatalogTest (activity name: com.experitest.UICatalogTest)

  • Browser - We also provide an instrumented browser application, SimpleBrowser, for web testing using the Web identification method: (activity name: com.experitest.browser)

Instructions for Your Developer

The following instructions should be transmitted to your developer, working with a MAC station and iOS device, so that the application can be prepared for testing. This preparation needs to be performed only once for the application.

Step 1: Open your project in Xcode

Step 2: Duplicate the target (note: when asked about the new Duplicate Target choose “Duplicate Only”

images/download/attachments/2688167/1.jpg

Step 3: Rename duplicated target (optional)

images/download/attachments/2688167/2.jpg

Step 4: Select duplicated target -> Go to build phases -> Select + in Link Binary With Libraries section.

images/download/attachments/2688167/3.jpg

Step 5: Search for QuartzCore.framework -> Press Add to link it.

images/download/attachments/2688167/4.jpg

Step 6: Search for CFNetwork.framework -> Press Add to link it.

images/download/attachments/2688167/5.jpg

Step 7: Press Add Other

images/download/attachments/2688167/6.jpg

Step 8: Locate Experitest.framework -> Press Open to link it.

Note: Only open the file Experitest.framework.zip on a Mac machine. Opening it on Windows and copying it to Mac machine result in problems with instrumentation.

images/download/attachments/2688167/7.jpg

Step 9: Final View : Build Phase -> Link Binary With Libraries

Note: When updating the Silk Mobile framework update, make sure framework does not get removed from the linked libraries.

images/download/attachments/2688167/8.jpg

Step 10: Go to Build Settings -> Search "other linker flag" -> Add following linker flags:

    1. -all_load

    2. -ObjC

Step 11: Final View : Build Settings -> Other Linker Flags

Note: At time of Silk Mobile framework update, please make sure linker flags do not change for the duplicated build settings.

images/download/attachments/2688167/9.jpg

Step 12: Switch to the duplicated target and deploy the application.

images/download/attachments/2688167/10.jpg

Step 13: Switch between the targets to run with and without the Experitest server.

Step 14: Register the Custom URL Scheme (so that the iOS Bridge will work).

  1. In the Project Navigator, expand the Supporting Files group and open the Project-Info.plist file.

    images/download/attachments/2688167/11.jpg

  2. You can add a new row by going to the menu and clicking Editor > Add Item. Set up a URL Types item by adding a new item.
    images/download/attachments/2688167/12.jpg

  3. Expand the URL types key, expand item 0, and add a new item, "URL schemes".
    images/download/attachments/2688167/13.jpg

  4. Fill in a string value for item 0 of "URL schemes". This value needs to be unique. For example, the app's activity name. The iOSBridge will open and close the application by this value. It should be a unique and a known name (is recommended that it will be the bundle identifier).

  5. Fill in your company identifier for the "URL identifier" (you can use any string, it will not be used later).
    images/download/attachments/2688167/14.jpg

Step 15: Verify that the instrumentation is working correctly.

Launch the application in a simulator. There are two signs that the instrumentation was successful:

  • In the simulator log you should be able to identify the following line: <Warning>: ExperitestServer: waiting for clients

  • When launching the application you should see the following splash screen:

    images/download/attachments/2688167/15.jpg